home *** CD-ROM | disk | FTP | other *** search
/ Tech Arsenal 1 / Tech Arsenal (Arsenal Computer).ISO / tek-04 / bincon10.zip / README.TXT < prev   
Text File  |  1993-02-12  |  9KB  |  182 lines
  1. February 11, 1993
  2.      ╔══════════════════════════════════════════════════════════════╗
  3.      ║        All of the files included in this BINCON package      ║
  4.      ║  are (C)opyright 1993 Tim Triemstra, All Rights are Reserved ║
  5.      ║                                                              ║
  6.      ║  The author can be contacted at:                             ║
  7.      ║  Internet: empath@ais.org                                    ║
  8.      ║  UUCP:     umcc!roofus!empath                                ║
  9.      ║  Fido:     Tim Triemstra @ 1:2410/339.1                      ║
  10.      ╚══════════════════════════════════════════════════════════════╝
  11.  
  12.      ALL EMPATH SOFTWARE CAN BE FOUND FOR DOWNLOAD FROM:
  13.  
  14.      Ground Zero BBS - Dearborn Michigan
  15.      (313)561-9274     Fido: 1:2410/339
  16.  
  17.  
  18. INTRODUCTION:
  19. _____________
  20.  
  21.     Welp, first off, here's what the heck this program does!  It is
  22.     a very simple program (as the source code will attest to.)
  23.     The BINCON program simply takes ANY type of file (especially
  24.     binary or image files) and converts it into a linkable list of
  25.     numbers for programming.  The data can be output in decimal or
  26.     hexidecimal formats.  The data numbers are formatted to look
  27.     pretty nice, and are an even 12 digits accross.
  28.  
  29.     My main purpose for writing this program is for easy adding of
  30.     bitmaps and palette information into the graphics programs.  This
  31.     is before I write my graphics library kernel, but I still want to
  32.     experiment with graphics bitmaps - reading from files stinks in my
  33.     mind.  This is also good for data that you may not want users to
  34.     realize IS data.  This is done by having your data right into the
  35.     program, not in an external file for anyone to edit.
  36.  
  37. WHAT IS INCLUDED:
  38. _________________
  39.  
  40.     BINCON16.EXE and BINCON32.EXE are the two compiled versions of
  41.     the program that are included.  The 16bit version hasn't been
  42.     tested very extensively.  I'm under the assumption that the 16bit
  43.     version simply won't work beyond a 64k limit of a file.  This is
  44.     because I didn't bother working with virtual files and such.
  45.     This reason is, of course, because I can include the 32bit version!!
  46.     The 32bit version is compiled with a special virtual-memory DOS
  47.     extender (by FlashTek for Zortech C++.)  This compiled version
  48.     will read ANY size file (unless you are running this little thing
  49.     on a file larger than 4G!  It requires a 386 of course, but that
  50.     is really the requirement for most of the programming languages
  51.     out now anyhow, right?
  52.  
  53.     The source code, BINCON.C, is also included.  It includes some of
  54.     the vital information included in this file at the top in comments.
  55.     More importantly, you can modify the way the hex or dec is printed
  56.     in the little loop at the bottom of the code.  This is so that you
  57.     can change the format of the output and such to your liking.
  58.  
  59.  
  60. HOW TO USE IT:
  61. ______________
  62.  
  63.     Here's the command line:
  64.     BINCON32 <FILENAME> <D|H> (start) (end) >output.dat
  65.  
  66.     FILENAME is obviously the input file.  It is the file you'd like
  67.     to convert to raw data.  The D or H represent (D)ecimal or (H)ex
  68.     output.  Both of the previous commands are required.  The (start)
  69.     is the first byte to start dumping from, (end) is where to stop.
  70.     You can enter a start without and end and the file will simply
  71.     be processed to the end.
  72.  
  73.     The >output.dat is just a pipe of output into a desired file.  I
  74.     decided to do it this way to allow yu to run the program through
  75.     the screen.  I do this alot to check through palettes.  It is also
  76.     good because you can print it out from the command line and such.
  77.     What they hey, DOS and UNIX created piping for a reason, I'm just
  78.     using it...  Modify it if you'd like something else.
  79.  
  80.     Skip some parameters and you'll get a parameter list.  You'll also
  81.     probably want to rename one of the files to something simpler, but
  82.     I thought it was most important that the filename be descriptive
  83.     for the release (I call the 32bit version binc.exe over here.)
  84.  
  85. EXTRA STUFF:
  86. ____________
  87.  
  88. For the most part, all the information about distribution and such is
  89. covered in the next section (and in the source.)  However, I thought
  90. I'd like to add that if you make modifications (that you KNOW will
  91. compile) that you would like compiled for 32bit virtual memory then
  92. send me the code and $10.  That will cover the cost of mailing you a
  93. disk (also, mention what disk size you want.)  If the modified code
  94. is good, I'll do an update and give you plenty of credit.  Trust me, I'm
  95. not releasing this to make money, and anyone that that does send a
  96. donation will be given back plenty for their $7 or so...
  97.  
  98. PS: I prefer to deal with people via internet mail, but it can cost
  99.     me some money to send too much binary info over the Inet lines.
  100.     If you have an email address, please include it.  I'll at LEAST
  101.     send you some mail with some updated source code and information
  102.     on any possible upgrade releases/executables which I could
  103.     mail you.  Rule of thumb: include all your information that could
  104.     possibly be relevant.  I don't give my info to ANYONE!
  105.  
  106.  
  107. OTHER STUFF -> INCLUDED IN THE SOURCE CODE:
  108. ___________________________________________
  109.  
  110.     This file is probably pretty ugly to alot of you "professional
  111.     programmers" (or anybody else actuall.)  However, since I am
  112.     just a guy who learned myself all mines knowledge on mines own =)
  113.     - don't expect too much.
  114.  
  115.     I included the source because there is probably a situation
  116.     that someone out there mich like some more functionality.  I can't
  117.     really think of anything off the top of my head (after all, I
  118.     wrote this program for myself anyhow.)
  119.  
  120.     Please, if this code influences you to write an application along
  121.     this line, release it as shareware/freeware.  The world needs
  122.     good programs and if we all have to spend our precious minutes
  123.     writing small tools like this then the real programs will take
  124.     alot longer.
  125.  
  126.     I'm constantly writing small programs like this myself and I try
  127.     to release them all into the public domain with source code.  The
  128.     only thing I ask is that if you use it constantly - distribute it!
  129.     After all, you're not the only wierd one out there that may like
  130.     this program.
  131.  
  132.     Finally, I doubt I'll do too much more with this program, but in
  133.     the interest of keeping the good stuff rolling, I do accept
  134.     donations.  I'll be sure to send you back some mail with some little
  135.     tidbit of code or info that you may find interesting.  Sometimes
  136.     it'll be an update, other times I'll send you other code that I may
  137.     be working on that you may be interested in.  If you have a specific
  138.     application you may want some help with, or are looking for little
  139.     tidbits, let me know.  I may have some code lying around...  And,
  140.     ESPECIALLY, if you have an internet mail site (or Fido I guess)
  141.     let me know it and I can get you alot more stuff sent to you.
  142.  
  143.     I'd ask for something like $7 for a general, all purpose donation.
  144.     If you'd like some graphics coding information (my real speciality)
  145.     I'll gladly send you a disk full of stuff for a little more money.
  146.     I prefer to handle most of this stuff via regular mail or, especially,
  147.     internet mail.  So, here's the info:
  148.  
  149.     Send any donations (along with your personal info so I can keep in
  150.     touch and send you some stuff you might like, and keep track of
  151.     my fellow programmers) to:
  152.  
  153.     Tim Triemstra
  154.     Empath Software
  155.     6238 College Drive
  156.     Dearborn Heights, MI 48127
  157.  
  158.     * Make any checks/money orders payable to Tim Triemstra, my bank is
  159.       still trying to charge me for depositing company checks so I don't
  160.       deal with them like that yet.
  161.  
  162.     I can be contacted at:
  163.     Internet:  empath@ais.org
  164.     Fidomail:  Tim Triemstra @ 1:2410/339.1 (I'm a point so I see it all)
  165.     UUCPmail:  umcc!roofus!empath
  166.  
  167.     This info is also included in the readme.txt, but I know I love to
  168.     delete those darn files so I put it here as well.  There IS some
  169.     other good info in the readme though too...
  170.  
  171. ___
  172.  
  173. I sure hope this code helps SOMEONE besides myself (although the people
  174. that may find it useful may never see it - unless you distribute the
  175. program.  PLEASE - distribute this file to your local BBS systems and
  176. FTP sites where people look for programming tools.  You could be helping
  177. the guy that figures out how to do a FAST fractal on a 8088 or some other
  178. gound breaking research =)
  179.  
  180. Tim.
  181.  
  182.